OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

GET Hero Relations

/openmlbb/mlbb/heroes/{hero_identifier}/relations

Open Only This

API Path: /api/heroes/{hero_identifier}/relations

Get information about the relations of a specific hero by ID or name. Supports query parameters for pagination and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero relation data:

  • records: Array of hero entries, each containing:
      • data:
          • hero:
              • data:
                  • name: Hero name.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • target_hero_id: Array of hero IDs that synergize well.
              • strong:
                  • target_hero_id: Array of hero IDs that are countered.
              • weak:
                  • target_hero_id: Array of hero IDs that counter this hero.

This endpoint is useful for:

  • Understanding hero synergies (assist).
  • Identifying heroes that are countered (strong).
  • Recognizing heroes that counter the selected hero (weak).
  • Building balanced team compositions.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.mlbb.hero_relations("miya", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
size query integer no 20
index query integer no 1
lang query string no en